<?php

 /**
 * @SWG\Swagger(
 *     swagger="2.0",
 *     schemes={"https"},
 *     host="tcmapi.emao.com",
 *     basePath="/v1.0",
 *     @SWG\Info(
 *         version="1.0.0",
 *         title="淘车猫 Api 文档",
 *         description="淘车猫 Api 文档"
 *     ),
 *      @SWG\Definition(definition="index",example={"code"=100,"data"={},"msg"="string"})
 * )
 * @SWG\Get(
 *     path="/persons",
 *     summary="获取一些人",
 *     description="返回包含所有人的列表。",
 *     @SWG\Response(
 *         response=200,
 *         description="一个用户列表",
 *         @SWG\Schema(
 *             type="array",
 *             @SWG\Items(
 *                  required={"username"},
 *             )
 *         ),
 *     ),
 * )
 */


    /**
 * @SWG\Get(
 *     path="/goods",
 *     summary="商品列表",
 *     description="返回包含所有商品的列表。",
 *     @SWG\Parameter(
 *       in="query",
 *       name="categoryId",
 *       description="商品类别",
 *       required=false,
 *       type="integer"
 *      ),
 *     @SWG\Parameter(
 *       in="query",
 *       name="userId",
 *       description="玩家ID",
 *       required=false,
 *       type="integer"
 *      ),
 *     @SWG\Response(
 *         response=200,
 *         description="商品列表",
*          @SWG\Schema(
*              @SWG\Property(
*                  property="code",
*                  type="number",
*              ),
*              @SWG\Property(
*                   property="data",
*                   type="object",
*              ),
*              @SWG\Property(
*                   property="msg",
*                   type="string"
*              )
*          ))
 *     ),
 * )
 */

 

    /**
     * @SWG\Post(
     *     path="/users",
     *     summary="商品列表",
     *     description="返回包含所有商品的列表。",
     *     @SWG\Parameter(
     *       in="formData",
     *       name="categoryId",
     *       description="商品类别",
     *       required=false,
     *       type="integer"
     *      ),
     *     @SWG\Parameter(
     *       in="path",
     *       name="categoryId1",
     *       description="商品类别",
     *       required=false,
     *       type="integer"
     *      ),
     *     @SWG\Parameter(
     *       in="body",
     *       name="categoryId2",
     *       description="商品类别",
     *       required=false,
     *       type="integer",
     *       *     @SWG\Schema(
*              @SWG\Property(
*                  property="firstName",
*                  type="string",
*              ),
*              @SWG\Property(
*                   property="lastName",
*                   type="string"
*              ),
*              @SWG\Property(
*                   property="username",
*                   type="string"
*              )
*          ),
     *      ),
     *     @SWG\Parameter(
     *       in="header",
     *       name="categoryId3",
     *       description="商品类别",
     *       required=false,
     *       type="integer"
     *      ),
     * @SWG\Response(response="200",description="ok",@SWG\Schema(ref="#/definitions/index"))
    * )
     */

    /**
     * @SWG\Put(
     *     path="/user",
     *     summary="更新玩家",
     *     description="返回包含玩家信息。", 
     *     @SWG\Parameter(
     *       in="path",
     *       name="userId",
     *       description="userId",
     *       required=true,
     *       type="integer"
     *      ),   
     * @SWG\Response(response="200",description="ok", @SWG\Schema(example={"username"="username","password"="password"}))
     * )
     */